feat: 템플릿 삭제(휴지통 이동) API (#82) - #84

관련 이슈

• closes [feat] 템플릿 삭제(휴지통 이동) API #82
• feat: 템플릿 사용 기록 API (#79) #80 병합 후 develop 위로 rebase하고 기준 브랜치를 develop으로 바꿨습니다.

작업 내용

명세 12번 DELETE /api/v1/templates/{templateId}. 템플릿을 휴지통으로 옮깁니다 (소프트 삭제).

• TemplateCommandService.delete: 메서드에 @Transactional. 변경 감지로 쓰고 @DynamicUpdate라 UPDATE에는 deleted_at·updated_at만 들어갑니다
• 조회는 findByIdAndUserId + 휴지통이면 거름 → 404_1. 새 레포지토리 메서드를 만들지 않았고, getActiveTemplate(휴지통이면 404_2)은 쓰지 않습니다
• Template.moveToTrash: 이미 휴지통이면 IllegalStateException (#15에서 미룬 휴지통 상태 검사). 덮어쓰면 30일 기한이 다시 시작되기 때문입니다. 서비스가 먼저 404_1로 막으므로 정상 경로에서는 나오지 않습니다 (코드 실수, 500)

커밋

1. 42ecdd7 엔티티 휴지통 상태 검사
2. 98c42e5 삭제 API (컨트롤러·서비스·dto, 서비스·통합 테스트)
3. 6d69494 동시성 테스트
4. 리뷰 반영: 동시성 테스트의 비우기를 실제 trashCommandService.empty로 교체

테스트

• 전체 1118개 통과 (develop 기준) (./gradlew clean build)
• TemplateDeleteControllerTest (통합): 성공 응답·no-store·+09:00·필드 순서, purgeAt = deletedAt + 30일, deleted_at·updated_at 갱신과 edited_at·last_used_at·created_at·이름·단축어·본문 유지, 휴지통 목록(15번)에 나오고 목록(8번)에서 빠짐·활성 개수 감소, 같은 단축어(대소문자만 다른 것 포함)로 새로 생성, 50개에서 403_1 → 삭제 → 생성 성공, 삭제 뒤 9·11·14번 404_2, 404 네 경우(내 휴지통은 deleted_at·updated_at 그대로), 숫자가 아닌 ID COMMON400_1, 토큰 없음 COMMON401_1
• TemplateDeleteConcurrencyTest (실제 커밋): 같은 템플릿 동시 삭제, 앞 삭제가 커밋 전일 때 뒤 삭제, 삭제↔비우기·삭제↔복구 양쪽 순서, 셋이 같은 순간에 오는 경우. 5번 반복해 모두 통과
• TemplateCommandServiceTest(모키토), TemplateTest(이미 휴지통이면 예외, deleted_at 그대로)

확인 체크리스트

• ./gradlew build 통과
• 테스트 포함
• 변경 400줄 안팎 → 약 770줄 (본 코드 약 100줄, 테스트 약 670줄). 통합·동시성 테스트 때문이고 기능은 나눌 수 없어 그대로 뒀습니다
• 병합된 마이그레이션 수정 안 함
• 비밀 값·개인정보 없음
• global 공통 코드 변경 없음
• 명세와 달라진 점 없음

리뷰어에게

1. 삭제도 회원 행을 먼저 잠급니다 (lockUser → 조회). 먼저 잠금 없이 구현해 동시성 테스트를 돌린 결과입니다.
   • 잠금이 없으면 같은 템플릿 동시 삭제가 ["SUCCESS", "SUCCESS"]였습니다. 뒤 요청이 커밋 전 스냅샷에서 활성 템플릿을 보고 행 잠금만 기다렸다가 deleted_at을 덮어써, 30일 기한이 다시 시작됐습니다.
   • 비우기·복구와 겹치는 경우는 잠금 없이도 500이 나지 않았습니다.
   • 템플릿 행만 FOR UPDATE로 잠가도 위 문제는 막히지만, 복구·영구 삭제·비우기(feat: 휴지통 템플릿 복구 API (#67) #69·feat: 휴지통 템플릿 영구 삭제 · 비우기 API #78)와 같은 순서(회원 행 → 템플릿 행)로 맞췄습니다. 같은 회원의 생성·복구와 줄을 서는 비용은 작습니다.
2. 동시성 테스트의 비우기는 실제 trashCommandService.empty를 부릅니다 (리뷰 반영). 처음에는 기준(feat: 템플릿 사용 기록 API (#79) #80)에 18번이 없어 JDBC로 흉내 냈습니다.
3. 엔티티를 읽으므로 본문 복호화에 실패하는 행은 삭제도 500입니다 (수정·사용 기록과 같음).
4. 정리 배치(00:10)와는 배치가 휴지통 행만, 삭제가 활성 행만 건드려 같은 행을 두고 다투지 않습니다.
5. 사용량 API(6번)가 아직 없어 활성 개수는 레포지토리로 확인했습니다.
6. 13번 단축어 확인이 같은 TemplateController·TemplateSuccessCode를 이어서 건드립니다 (200_5는 200_4와 200_6 사이).

🤖 Generated with Claude Code